Notifications
Configure
image

No Data found

You don't have any notifications

Header Image
Guide
Create a variant group: Full setup
Last updated on Jul 2, 2025
Reading time: 6 min
Overview

As a Marketplace seller, you can create variant groups in Seller Center or with Walmart APIs. In this guide, you’ll learn how to create a variant group with 50 or more items using the Full Setup Template in Seller Center. 

Notes

Too many variations can be confusing for customers. We recommend no more than 50 items for a variant group with a single attribute (a T-shirt in two colors and three sizes) and no more than 500 items for a variant group with multiple attributes (a pair of pants in 25 sizes and 20 colors). 


Full setup   

Step 1 — Get started 

Navigate to your Catalog  in Seller Center and select the Add items button. Select the Upload in bulk link located under Add thousands of items using a spreadsheet. On the next page, in the New items section, select the Build spreadsheet button.



Step 2 — Choose a fulfillment method and a product category type

Select your fulfillment method, then select Next. Choose the product categories that best fit the items you want to add, then choose Next. Then, choose up to 10 product types per product category. Once you’ve chosen your product types, choose Next. If you aren't sure which classification to choose, review our Content standards: Overview. When you’re ready, select the Build spreadsheet button. If you chose both fulfillment method options, two templates will download. 


Step 3 — Add variant attributes

There are five columns you must fill out to successfully set up a variant group. Locate column DD to find the variant columns. All items in a variant group should be included as separate items in the template. For example, a T-shirt in two colors and three different sizes would have six rows with each variation defined in a separate row.  


Column 

Context 

Variant Group ID 

This is a unique alphanumeric identifier, up to 20 characters in length (e.g.,DryFit_VG5). You’ll use this to track your variant group in the Catalog dashboard once it’s been created. 

Variant Attribute Names (+)

Attribute names indicate which attributes vary within the group, such as size or color in the example of a clothing group. If your items vary for multiple attributes (e.g., different colors and sizes), you can add more columns. You can't create custom variant attribute names. You must select an option from the dropdown. 

Is Primary Variant

The primary variant provides suggestions on which variant should be highlighted in search. Based on customer search, Walmart will optimize the variant to display to the customer which may not match the primary variant provided. If you select Yes on more than one item in a single variant group, your submission may fail. Consider selecting the top-selling item or the item with the most inventory as the primary variant.

If your item is a merged variant group, the primary variant you select may not be the primary variant that appears on Walmart.com.

Swatch Image URL

You’ll need to include an image for each variation of the swatch, but not each variation within the group. For example, the same URL could be used for a green T-shirt in three different sizes. Swatch image URLs must follow our image guidelines.

If you don't provide a swatch image URL, variants will appear as tiles with the color stated as text on Walmart.com. Walmart may choose a swatch image from your primary or secondary images to optimize variants for the customer experience.  

Swatch Variant Attribute

The swatch image requirement varies by product type. Visual variants can be displayed as swatches on the item page. For example, if a T-shirt comes in three colors, the swatch variant attribute would be set to color. 


Step 4 — Upload the template 

Once you’ve appropriately filled out the template, you can upload it by navigating back to your Catalog in Seller Center, then select Add Items. You can drop your updated file in the Upload in bulk  link located under Add thousands of items using a spreadsheet. Updates can appear as quickly as 15 minutes or can take up to four hours. 

Tell us what you think

More in Item setup
Item setup methods: Overview
Item setup
This guide gives a high-level overview to start to build your product listings on Walmart Marketplace.
Add multiple items: Express setup
Item setup
This guide shows you how to add a new item to your catalog by searching products that are currently listed on Walmart.com. If you’re adding a new item to your catalog that’s not currently offered on Walmart, review Add a single item: Full setup.
Add multiple items: Match Walmart’s catalog
Item setup
In this guide, you’ll learn how to add multiple items to your catalog in Seller Center by matching them to products that are currently listed on Walmart.com.
About Walmart.com

Walmart Inc. (NYSE:WMT) helps people around the world save money and live better- anytime and anywhere - in retail stores, online, and through their mobile devices. Each week, approximately 240 million customers and members visit more than 10,500 stores and numerous eCommerce websites in 20 countries. With fiscal year 2023 revenue of $611 billion, Walmart employs approximately 2.1 million associates worldwide. Walmart continues to be a leader in sustainability, corporate philanthropy and employment opportunity.

c2025 Walmart. All Rights Reserved  | Privacy Policy